home *** CD-ROM | disk | FTP | other *** search
/ Popular Request / By Popular Request (Arsenal Computer)(SysOptics Distribution System).ISO / amiga1 / dlgtn121.lha / readme < prev    next >
Text File  |  1993-08-09  |  9KB  |  215 lines
  1. Setting up TIN under DLG.
  2.  
  3. Running TIN under DLGpro is fairly straighforward. Here's what you need to do
  4. to get started.
  5.  
  6. System Requirements
  7. ===================
  8.  
  9. In order to run TIN under DLG you will need approximately 512k RAM per
  10. user [you can probably get away with less]. Each user will also use
  11. approx 100k of disk space as well. Since the current version of TIN is
  12. pure, you can make it resident, thus saving some space if you're running
  13. multiple copies.
  14.  
  15. In addition you will need some disk space for the article index maintained
  16. by TIND. This will depend on the size of your newsfeed. In my case
  17. [Equinox runs a full newsfeed] this is around 5MB.
  18.  
  19. By default the article index is kept under uunews: but it is possible to
  20. move this if you wish. If you SETENV TIN_INDEX to the desired directory,
  21. the index will be kept beneath the specified directory. This can be useful
  22. in order to minimise disk thrashing when running TIND, you will find
  23. performance is improved if the index and uunews: are on separate drives.
  24.  
  25. If you wish to have multiple users running TIN you must be using WB2.04
  26. or better, as TIN relies on the WB2.0 local environment to set up user
  27. variables.
  28.  
  29. Installation
  30. ============
  31.  
  32. Create a directory for the TIN files and assign tin: to your directory.
  33. Copy the files from the archive to the appropriate directories. Follow
  34. the installation instructions for TIN.
  35.  
  36. Create a menu entry which will run tin. This should be a Menu Script, set
  37. it to run 'tin:tin.dlg'. The current tin:tin.dlg uses MAKERES and MAKEUNRES
  38. in order to make TIN resident on demand [i.e when no users are running TIN
  39. it will not be left sitting around in memory]. If you wish to make TIN
  40. permanently resident, or if you don't want TIN to be resident at all, you
  41. should remove the MAKERES and MAKEUNRES lines. [If TIN is not resident, the
  42. EXE line in tin.dlg must be changed to: EXE tin:tin.exe ]
  43.  
  44. Create a menu entry for bundling news saved from within TIN [if required]
  45. this should be a batch file set to run DLGconfig:batch/bundle_news %UNAME
  46.  
  47. In order for bundle_news to work correctly, you will need DLGupload
  48. [provided with this archive], rename the executable to 'upload' and put it 
  49. somewhere in your path.
  50.  
  51. If users wish to check their saved news before bundling you can add another
  52. menu item to do this. It should run an executable as follows:
  53. c:list user:%UNAME/news
  54.  
  55. Since TIN reads articles directly from uunews: there is no need to do
  56. all that messy importing and assigning that DLG normally requires and
  57. you can delete your DLG UseNet message areas completely if you're happy
  58. to have all your UseNet users running TIN.
  59.  
  60. The TIN indexing daemon will need to be run periodically. How often will
  61. depend on the size of your newsfeed and how often you update it. I run
  62. TIND every 4 hours which seems to be plenty. Some environment variables
  63. need to be set up in order to prevent TIND from creating spurious NEWS
  64. and MAIL directories. The batch file index_daemon provides an example
  65. of this.
  66.  
  67. If you aren't running CNews, you will also have to run actived, this
  68. reads your newsgroups file and your uunews:.next files and creates a
  69. new active file in uulib: the batch file active_daemon shows how to set
  70. this up, renaming the existing active file allows this to be run without
  71. problems if someone is running TIN at the time. I run this batch every
  72. half hour. If you don't run actived regularly, TIN users will never see
  73. new articles that arrive on your machine.
  74.  
  75. Real Names & Aliases
  76. ====================
  77.  
  78. We have TIN set up so that DLG's %UNAME corresponds to the users ID,
  79. and %ALIAS corresponds to the users real name, this allows users to
  80. log in with a 'handle' and have their real name in their alias. e.g.
  81.  
  82. DLG        : Joe_Bloggs@equinox.gen.nz (bloggsy)
  83. Unix, DLG/TIN    : bloggsy@equinox.gen.nz (Joe Bloggs)
  84.  
  85. In order to do this of course, users would have to log in with their
  86. handle when DLG asks for first and last name, and their real name when
  87. DLG asks for an alias, which sounds a bit backwards. Nevertheless it
  88. still works OK if the user has given DLG their real name.
  89.  
  90. Basically the Alias is there, so the user has control over what goes
  91. inside the (). You can change this easily if you don't like it.
  92.  
  93. Restricting Access
  94. ==================
  95.  
  96. It may be desirable to provide selective access to newsgroups for some
  97. users e.g. you may wish to make some newsgroups unavailable to minors.
  98.  
  99. This can be achieved by creating fake active files which to not include
  100. the groups you want to restrict, and telling TIN to use the fake file.
  101.  
  102. The program SETACTIVE is used to set the environment variable TIN_ACTIVE
  103. according to the data in the tin:access file. Access can be by user name
  104. or user level [or in fact any string or number can be used].
  105.  
  106. The tin:access file contains a token variable pair on each line. The token
  107. is either be a string [user name] or a number [user level]. The variable
  108. is the name of the active file for that user. [do not prepend uulib: to 
  109. this!]
  110.  
  111. Access by user level.
  112.  
  113. The access file is searched until a token less than or equal to the
  114. given level is found. If there is no token less than or equal to the
  115. given level then TIN_ACTIVE is unset. This means that the level tokens
  116. must be listed in descending order in the access file.
  117.  
  118. Access by user name.
  119.  
  120. The access file is searched until a token matching the given name is
  121. found. If there is no token matching the given name then TIN_ACTIVE
  122. is unset.
  123.  
  124. Note that if TIN_ACTIVE is unset, or the file specified does not exist,
  125. TIN will use UULIB:active as the active file. For this reason you should
  126. make UULIB:active the lowest common denominator of the various active
  127. files you wish to use [otherwise an error could result in someone accessing
  128. the full active file].
  129.  
  130. For examples of tin:access and uulib:banned see the files tin/access_by_name,
  131. tin/access_by_level and uulib/banned in the archive.
  132.  
  133. If you do not wish to restrict access, you should remove the EXE setactive
  134. line from tin.dlg
  135.  
  136. Creating Active files.
  137.  
  138. The active file is created periodically by active_daemon, so this is the
  139. logical place to create the fake files as well. The supplied active_daemon
  140. has an example using grep which creates UULIB:active excluding the
  141. newsgroups in the banned file, and UULIB:active.dude including all
  142. newsgroups. Cnews users will not need to run active_daemon normally,
  143. but a similar technique can be used to create fake active files for TIN.
  144.  
  145. By using these techniques it is possible to have any number
  146. of different access restrictions in place, it's simply a matter of
  147. creating the active files, and using SETACTIVE to point the users at
  148. the appropriate one.
  149.  
  150. Execing with EXEC
  151. =================
  152.  
  153. Included with this archive is EXEC, which is used to run resident
  154. [or internal] programs from a DLG menu script. In tin.dlg EXEC is used
  155. to run TIN when it has been made resident.
  156.  
  157. Usage: exec [-s<stacksize>] command [arg1 .. argn]
  158.  
  159. EXEC is also useful when using tptshell, since it can be used to execute
  160. scripts and resident programs which can't normally be done from tptshell.
  161.  
  162. Trimming with TRIM
  163. ==================
  164.  
  165. We include in the archive a small trimnews replacement called trim, trim
  166. is faster than trimnews and responds to a break.
  167.  
  168. usage: trim [-v] [-t n] [-f <filename>]
  169.  
  170. Without any arguments Trim will behave just like trimnews, however instead
  171. of outputting the delete information, trim will display the names of .next
  172. files which are greater than 14 days old. Use the -v flag if you wish to
  173. see the delete information. The -t n flag can be used if you wish to change
  174. the number of days expiry from that specified in the newsgroups file, e.g.
  175. if you have all your newsgroups set to expire at 5 days, and wish to trim
  176. back to 4 days, type: trim -t 1, this subtracts 1 from the expiry time for
  177. each newsgroup in the newsgroups file. If you wish to use a different
  178. newsgroups file from the default [uulib:newsgroups], use the -f <filename>
  179. option.
  180.  
  181. One disadvantage of trim, is that it cannot cope with a break in the
  182. sequential numbering of news articles, therefore it may be wise to
  183. run trimnews from time to time to pick up any stray articles.
  184.  
  185. Changes for 1.2 PL1
  186. ===================
  187.  
  188. The Tin indexing structure is changed in this release, therefore it is
  189. essential that you use the TIND included here with Tin 1.2 PL1. You should
  190. also delete all your old index files before running Tin.
  191.  
  192. A new version of doarchive is included which will work with any archiver
  193. properly installed into DLG.
  194.  
  195. Acknowledgements
  196. ================
  197.  
  198. We include some PD executables with this archive which we have found useful
  199. when running TIN under DLG. The stuff we have written we have provided
  200. source for, we wish to acknowledge the various authors of the other
  201. executables which we have included for the sake of completeness.
  202.  
  203. Thanks to Erik Karlin for the updated doarchive.
  204.  
  205. We would also like to thank the DLG sysops who have sent us feedback
  206. and suggestions.
  207.  
  208. In Case of Problems, Contact:
  209. =============================
  210.  
  211. Geoff McCaughan - geoff@satori.equinox.gen.nz
  212. Mark Tomlinson  - mark@garden.equinox.gen.nz
  213.  
  214. Who also brought you KiwiElm, Telnet and FTP for the Amiga
  215.